


THE LECTURER: Toby Riley is a C-E-l-R, 
INC., senior consultant in program develop¬ 
ment who has more than ten years experi¬ 
ence in the field of computer sciences. He 
has served as project director for such 
large-scale programs as Du Pont’s RAMPS 

(8,500 FORTAN state¬ 
ments) and the NASA 
Launch Vehicle Model. 
Riley is a member of 
ACM and the British 
Computer Society, and 
has been guest lecturer 
in computer sciences 
at the London School 
of Economics, the Regent Street Polytechnic 
and Woolwich Polytechnic Institute. In ad¬ 
dition, he has conducted programming 
courses for more than 200 scientists and 
50 professional programmers for NASA. He 
is currently conducting similar courses for 
the FAA and the USDA Graduate School. 
During his experience with both IBM and 
C-E-l-R, Riley has programmed on all the 
IBM 1400 and 7000 series computers, as 
well as several systems in the UNIVAC Sci¬ 
entific series, and Burroughs, GE, and RCA 
computers. Riley received his undergradu¬ 
ate degree from Swarthmore and has com¬ 
pleted two years of graduate studies at the 
Case Institute of Technology. 




h A 

INSTITUTE FOR ADVANCED TECHNOLOGY 

REGISTRATION: Tuition, including noon 
meals and all course materials, is $220 for 
the first student and $195 for each addi¬ 
tional student from the same organization. 
Classes begin each day at 9 a.m. and con¬ 
tinue through 5 p.m. Hotel rooms are not 
included. 

HOTEL ACCOMMODATIONS: The semi¬ 
nar will be given at the Statler Hilton Hotel, 
16th and K Streets, N.W., Washington, D. C. 
The Statler Hilton will hold a block of rooms 
for advance reservation by students until 
two weeks prior to the seminar. 

OTHER COURSES: Among other seminars 
in the C-E-l-R seminar program is: 

SURVEY OF DATA COMMUNICATIONS 

For data processing personnel preparing for 
“on line” or “real time” systems involving 
data communications. Covers hardware and 
software considerations important to suc¬ 
cessful system design, and data communi¬ 
cations concepts and terminology. Executive 
House, Washington, D. C., June 21-22-23. 

For an outline of this seminar or others 
scheduled in coming months, write: 

Registrar 

Institute for Advanced Technology 

1200 Jefferson Davis Highway 
Arlington, Virginia 22202 
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Documentation 

and 


Statler-Hilton Hotel 
Washington, D. C. 

June 14-15-16-17 

A four-day seminar for working pro¬ 
grammers and programming managers 
designed to review current practice 
and suggest standards for effective 
operations. Two days and one evening 
session are spent on documentation. 
This section covers problems, meth¬ 
ods, standards, formal systems, and 
needs of differing installations. A 
visit to a Washington area installa¬ 
tion is included, as well as a work¬ 
shop session in which student pro¬ 
grams are processed by automatic 
documentation systems. The two-day 
session on debugging covers planning 
and estimating debugging time, meth¬ 
ods, types of errors, standards, and 
effects of the program environment. 
Tuition, including luncheons and 
course materials, is $220 for the first 
student and $195 for others from the 
same organization. 


Institute for Advanced Technology 
1200 Jefferson Davis Highway 
Arlington, Virginia 22202 
(703) 684-6377 Ext. 494 
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COMPUTER PROGRAM 
DOCUMENTATION & DEBUGGING 


FIRST DAY 

DOCUMENTATION CONCEPTS 

Documentation Consumers 

Identification of the Consumers of Docu¬ 
mentation. Requirements and variable needs 
of programmers, operators, management 
and users. 

Elements of Documentation 

Taxonomy and definitions of tools and arti¬ 
facts of documentation. Alternative means 
of documenting the same information. 

Current Forms of Documentation 

Review of various types of forms and their 
application. 

Automated Documentation 

Discussion and explanation of several avail¬ 
able automated block-diagramming and 
documentation program systems. Problem 
exercise. 

Evening Workship Session 

“Hands-on” computer processing of docu¬ 
mentation exercise at C-E-l-R Computer 
Center. 


SECOND DAY 

STANDARDS AND PRACTICES 

Program Documentation Standards 

Review of standards development at the 
organizational, national, and international 
level. Eg. American Standards Association 
standard on Flow-Chart Symbols. 

Current Practices in Documentation 

Review and critique of documentation pro¬ 
cedures and standards used by several 
organizations. 

Documentation Support Activities 

Presentation of the services provided by a 
staff support group in documentation. 

Problems of Documentation 

Evaluation of implementation problems for 


maintaining valid documentation, and dis¬ 
cussion for their solution. 

Case Study in Documentation Practices 

Field trip to a local installation to review 
documentation concepts, procedures, and 
standards. 


THIRD DAY 

PROGRAM DEBUGGING 

Definition and Scope of Debugging 

Defining means for determining when a 
program is completed. Discussion of error- 
free coding and its cost. 

Types of Errors 

Taxonomy of various types of errors, and 
their authors. 

Software Aids for Debugging 

Review of commonly used techniques for 
error detection and removal. A detailed 
description of several new software systems. 


FOURTH DAY 

PROGRAM PLANNING 
Causes of Errors 

Outline of reasons why errors occur, by level 
of organization and their effects. Applica¬ 
tions, pressures, attitudes, etc. 

Preventative Measures Versus Cures 

Discussion of methods for preventing errors. 
Selection of coding language, program ver¬ 
sus problem segmentation. 

Effects of Programming Environment 
on Debugging 

Presentation of techniques for creating en¬ 
vironment for programming efficiency, and 
related procedural practices. 

Summary and Conclusion 

Open discussion and review, questions and 
answers. 




D H °HI" 1 ' is an international 
applied research and data processing cor¬ 
poration that offers analytical, scientific and 
computer services to business, science and 
government. Founded in 1954, it is today the 
world's largest, most experienced and best 
equipped independent organization in its 
field. The C-E-l-R professional staff includes 
several hundred mathematicians, statisti¬ 
cians, economists, operations researchers, 
management scientists and others from a 
variety of disciplines. In addition, many of 
the finest scientific and professional men in 
America are retained on a consultant basis. 
Augmenting this professional capability are 
modern electronic computing equipment, 
and skilled computer programmers and op¬ 
erations personnel at computing centers in 
five major U.S. cities, London, The Hague 
and Mexico City. 
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long-standing involvement in management 
education. The revolutionary nature of com¬ 
puter-based methods made education an in¬ 
tegral part of C-E-l-R operations from the 
beginning. This relationship is formalized 
through the Institute for Advanced Tech¬ 
nology. I AT faculty members are drawn 
primarily from the ranks of C-E-I-R’s pro¬ 
fessional and computer operations staffs. 
Its curriculum is drawn from subjects in 
which C-E-l-R staff members are expert- 
recognized for excellence in day-to-day ap¬ 
plication of the art and science of computer 
usage to the real problems of C-E-l-R cus¬ 
tomers in business and industry. Sharing 
these new skills through seminars in major 
cities, management clinics, and special, in- 
plant training programs is the major goal of 
the Institute for Advanced Technology. 
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DOCUMENTATION AND 
DEBUGGING -- BASICS OF 
EFFECTIVE PROGRAMMING 


Dear Sir: 

You may want to argue with Tohy Riley during his presentation of the Computer 
Program Documentation & Debugging seminar. As a matter of fact, we hope you will, 
because the ground he covers involves two controversial aspects of programming that 
are not often approached in terms of objective standards. 


Riley has some firm beliefs about documentation and debugging acquired over a 
ten-year career in programming and programmer management. Working for a company 
that built its reputation largely in development of computer software on a contract 
basis 5 Riley T s beliefs are, frankly, colored by the need to deliver computer pro¬ 
grams on time, to specifications, and within a budget. 

If you have seen programming money slurp down the drain because of inadequate 
(or over-adequate) documentation, or through debugging that cost too much man time 
and machine time, you may have considered such possible causes as: 

• Informal or non-existent training in two basic programming skills--docu- 
mentation and debugging. 

• The absence of practical standards for defining and managing the docu¬ 
mentation and debugging tasks. 

That T s what this seminar is concerned with. Designed for both the programmer 
and the programming manager, it covers documentation and debugging from A to Z at 
a practical, working level. In each area it first defines the subject, then reviews 
current practices, and winds up with an outline for workable performance standards. 


You may have concluded at this point that Riley figures he knows it all. He 
doesn f t. And the conclusions reached in this seminar won f t necessarily be his own-- 
he expects you to come prepared to argue the point whenever you think he T s off the 
track. The idea is to open up discussion and lead it to a consensus acceptable to 
the entire group. 


We said that a good part of C-E-I-R T s reputation is built on its performance 
in computer software development. And that Riley, in his years with IBM and 
C-E-I-R has developed a healthy appreciation and understanding of the importance of 
documentation and debugging. 


An example of what we mean is C-E-I-R T s development of a resource allocation 
model (under the lecturer 1 s direction) with the E.I. du Pont de Nemours & Company. 
This program consists of more than 8,500 FORTRAN statements, and was under develop¬ 
ment for two years. Throughout this period, programmers, mathematicians, and 
engineers were kept in constant communication regarding development of algorithms, 
practicality of the approach, and data processing problems. The program was sub¬ 
jected to in-house testing, then on-site field testing in several different client 
locations, each with different conditions. 
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In every instance, the documentation had to he complete for each of the different 
staffs involved during the year the program underwent field tests. This documenta¬ 
tion included program lists, explanation of algorithms, test correspondence, training 
texts and user f s guides. Tasks such as this one helped C-E-I-R (and Riley) appre¬ 
ciate the problems of programming for multi-installation use, and meeting a variety 
of specifications for a common program. 

During this seminar you will he asked to consider the problem of meaningful 
problem definition, and answer the question of what to document, and when to docu¬ 
ment it, and why. 

Each participant is asked to bring along two computer programs: one that you be¬ 
lieve to represent most features of a well-documented program, and a second program 
that you will use in a class exercise. 

In the class problem you will see your second program processed by two automatic 
documentation systems -[Flowcharter and the Symbolic Block Diagram System] at C-E-I-R T s 
computing center. You will discuss and evaluate the results of these systems, and 
consider other special documenting routines that can be written or used by 
programmers. 


* . 
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This seminar will benefit any practicing programmer or programmer manager by 
focusing his attention on important aspects of his job whose proper handling can: 


o Extend program life by simplifying the job of making changes and conversions. 

o Improve manager-programmer communication by setting ground rules for objec¬ 
tives, methods and status reporting. 

o Facilitate the exchange of information between programmers and thereby better 
coordinate the group effort. 

o Reduce the amount of man and machine time spent in program debugging. 

o Increase the efficiency--and reduce the cost -- of the programming 
operation. 


This seminar will be given June l4, 15, l6 and 17 at the Statler-Hilton Hotel in 
Washington, D.C. These are four days that can help you advance your professional 
career. Circle them on your calendar now, and mail the enclosed registration form. 

We look forward to meeting you. 



p.s. If the June date is inconvenient for you, please ask about future sessions. 
Because class sizes are limited, additional unannounced presentations of 
C-E-I-R seminars are often added to the schedule. 
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